home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / hangem.zip / HANGEM.DOC < prev    next >
Text File  |  1991-06-29  |  18KB  |  594 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ┌────────────────────────────────────────────┐
  15.                  │                                            │
  16.                  │                   Hang 'Em                 │
  17.                  │           =======================          │
  18.                  │                                            │
  19.                  │         A Live Game for Many BBS's         │
  20.                  │                                            │
  21.                  │   Game Release Version 1.0 - 01/01/91      │
  22.                  │                                            │
  23.                  │             (C)opyright 1990               │
  24.                  │                                            │
  25.                  │                   By                       │
  26.                  │                                            │
  27.                  │            SECRET SERVICE BBS              │
  28.                  │                                            │
  29.                  │              Mike Wilson                   │
  30.                  │             P.O. Box 9521                  │
  31.                  │            Huntington, WV                  │
  32.                  │                  25704                     │
  33.                  │                                            │
  34.                  │            BBS (304) 429-6838              │
  35.                  │            1200/2400/9600 24 hrs.          │
  36.                  │                                            │
  37.                  │                                            │
  38.                  │                                            │
  39.                  │                                            │
  40.                  └────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                    Hang 'Em  (C)opyright 1990 - Page 1
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                   Warranty
  77.  
  78.  
  79. This is product is provided "as is" without warranty of any kind.  The
  80. entire risk as to the results and performance of the program is assumed by you.
  81. Futher more, I the author do not warrant, guarantee, or make any representations
  82. regarding the use of, or the results of the use of the program, and you rely on
  83. the program and results solely at your risk.  I the author cannot accept
  84. responsibility for system damage, loss of profit, or any other special,
  85. incidental, or consequential damages resulting from the use or inability to use
  86. this product.
  87.  
  88.  
  89.                                  Copyright
  90.  
  91.  
  92. The Multi-Board Hang 'Em live game is distributed as SHAREWARE.
  93. Under this concept you may use the SHAREWARE (unregistered) version for a
  94. reasonable period of time, which I consider to be three weeks, after which you
  95. must either register your copy or discontinue usage.
  96.  
  97.  
  98.                                Registration
  99.  
  100. With registration you will recieve the latest registered copy of Hang 'Em with
  101. the ability to download any futher updates from Secret Service
  102. BBS at no extra cost.  You will also recieve any support the author can give in
  103. reference to bugs or other problems that may arise in using the game.
  104.  
  105. I feel that sysop's have enough expense without charging a high cost for a game
  106. for their users.  I have set the cost of registration at $15.00 which I feel if
  107. people will follow the shareware concept will be enough to cover shipping and
  108. handling and encourage me to write more doors.
  109. See register.txt for information on ordering.
  110.  
  111.                                Distribution
  112.  
  113. You are free, in fact encouraged, to distribute the SHAREWARE (unregistered)
  114. version of Multi-board  Hang 'Em Live Game provided that all files
  115. contained in the original Hang 'Em archive are distributed in their
  116. original unmodified state.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                    Hang 'Em  (C)opyright 1990 - Page 2
  133.  
  134.  
  135.                                Introduction
  136.                                      &
  137.                                 How To Play
  138.  
  139. The Game of Hang 'Em presents five different word lists that are
  140. based on various subject matter. The user picks a list that
  141. would be of interest to them. They then choose letters that they feel
  142. may appear in the word. If they are not correct then an appendage is
  143. added to the hangmans noose. The user must guess the word before he
  144. is 'hanged'.  Score is awarded at $10 for each letter in a correctly
  145. guessed word.
  146.  
  147.  
  148.                           Options and Information
  149.  
  150. This door game will also create color and mono top 10 bulletins and write them
  151. in directories of your choice written in the .CFG file.
  152. The game tracks the montly champion and also displays it within the color and
  153. ascii bulletins.
  154.  
  155.  
  156.  
  157.                             Installation and Setup
  158.  
  159. Installation is relatively simple.  Create a directory and dissolve the
  160. contents of Hangem.zip into it.  Run setup.exe and answer the questions
  161. as they appear. If you have problem answering a question refer to the
  162. detailed instructions below.
  163. Set up a batch file to call the game from your board (See below under
  164. Batch Files for your particular board setup).
  165. Thats all there is to it!
  166.  
  167. Below is a detailed description of what is in each file:
  168.  
  169. Hangem.CFG contains:
  170.  
  171. The Secret Service BBS           <-- Name of BBS
  172. Mike                             <-- Sysop's first name
  173. Wilson                           <-- Sysop's last name
  174. C:\Path\BBSInfo.???  <-- Path and filename to Board Info. file (See below)
  175. C:\Path\Color.scr <-- Path & Filename to create COLOR bulletin
  176. C:\Path\Mono.bbs  <-- Path & Filename to create MONO bulletin
  177. NO                <-- NO or locked COM PORT Baud Rate
  178. U          <-- U for Unlimited plays per day O for Once per day
  179. COMPUTERS  <-- WORD1.LST TOPIC (MUST NOT CHANGE IF USING LISTS IN ZIP!)
  180. SPORTS     <-- WORD2.LST TOPIC (MUST NOT CHANGE IF USING LISTS IN ZIP!)
  181. ANIMALS    <-- WORD3.LST TOPIC (MUST NOT CHANGE IF USING LISTS IN ZIP!)
  182. THE BIBLE  <-- WORD4.LST TOPIC (MUST NOT CHANGE IF USING LISTS IN ZIP!)
  183. TRAVEL     <-- WORD5.LST TOPIC (MUST NOT CHANGE IF USING LISTS IN ZIP!)
  184.  
  185. The line that asks for path and file name for Board Info. file is refering
  186. to the paricular file your board creates when it drops out to run a game.
  187. This would be:
  188. Wildcat prior to V3.0 ---> Callinfo.bbs    Spitfire -------> SFDoors.dat
  189. GAP or WILDCAT 3.0+ -----> Door.sys        PCBoard --------> PCBoard.sys
  190. QuickBBS ----> DorinfoX.def (The X is 1 or 2 depending on node #)
  191.  
  192. The lines referencing path and filename to write the Color and Mono
  193. top ten bulletins screens must be any path and proper dos file name.
  194.  
  195.  
  196.  
  197.  
  198.                    Hang'Em  (C)opyright 1990  Page - 3
  199.  
  200.  
  201. IN LOCAL MODE THE SYSOP WILL NOT BE ABLE TO VIEW THE FIVE TOPIC AREAS WITHIN
  202. THE GAME! LOCAL ONLY INSERTS "WORDS RELATED TO VARIOUS TOPICS" IN PLACE OF
  203. WHAT THE USER WILL SEE SUCH AS BIBLE OR SPORTS!
  204. The last five lines in the .cfg file are the topics that are presented to users
  205. of words within the game. These should remain the same if you use the word lists
  206. that came in the zip.  The sysop may make up his own word lists for the game and
  207. enter the topic of them on the correct lines of the .cfg file if he wishes. The
  208. same words may get old after a long period of play and replacement of the word
  209. lists will be desireable. The first line corresponds to words within the file
  210. word1.lst, the second line word2.lst, etc.
  211.  
  212. MAKING YOUR OWN WORD LISTS FOR THE GAME
  213. ---------------------------------------
  214. YOU DO NOT HAVE TO MAKE WORD LISTS! YOU MAY USE THE ONES THAT CAME
  215. WITHIN THE ZIP!  IF YOU DO WISH TO MAKE YOUR OWN LISTS OF WORDS FOR
  216. THE GAME THEN READ THE FOLLOWING!
  217.  
  218. A sysop must follow these guidelines in developing his own word lists!
  219.  
  220. *  The list must have EXACTLY 60 entries.
  221. *  The words can NOT be less than 4 letters or more than 10!
  222. *  There should NOT be a carriage return on the last line of the file.
  223.    or you will see an error 9 displayed when that list is chosen.
  224. *  There are five word lists that you may replace. These lists are called
  225.    word1.lst, word2.lst, word3.lst , word4.lst and word5.lst. These files
  226.    must be named EXACTLY like that!
  227. *  All words entered must be in " ". EXAMPLE:  "WORD"
  228. *  Topics should be changed in the .cfg to refer to the correct word list
  229.    so that a user doesn't pick words that relate to sports and get a word
  230.    that relates to the new topics you have added.
  231. *  The program has built in error detection for file lists. If a list is shorter
  232.    than 60 it will send a message to the user that the file is missing some
  233.    words and that they should tell the sysop. It will not crash or lock up!
  234.    They may then choose a proper working alternate list.
  235. *  If you enter a word more than 10 letters or less than 4 it will not lock up
  236.    but also display for the user that an improper word was found. It will then
  237.    go to a proper word.
  238.  
  239.  
  240.  
  241.  
  242. NOTE FOR MULTI NODES!
  243. You may now have several .cfg files to allow use on multinode systems.
  244. Use the above .cfg format but name each .cfg file differently. You
  245. may call them what you want as long as you correctly call them from
  246. the batch file command line.
  247.  
  248. Example:    Node1:     game game.cfg
  249.  
  250.             Node2:     game game1.cfg
  251.  
  252.  
  253. ** For Multi-node boards that need to alter the Com 3 or 4 address or use
  254.    a Non-standard IRQ setting please read the file Port.doc!
  255.  
  256.  
  257. Hangem.DAT contains:
  258.  
  259.  
  260. This file contains the following user data:
  261.  
  262. "Mike Wilson","10-21-1990","100"
  263.  
  264.                    Hang 'Em  (C)opyright 1990  Page - 4
  265.  
  266. Data has to be kept in this format, but you can delete all lines except for
  267. line number 1 which is the Last Months Champ line. You can alter line 1 but
  268. not remove it. You need to alter line 1's Date form 10-21-1990 to the month
  269. that your setting up this door. For example if it is December just simply
  270. change the Date to 12-01-1990. It doesn't matter if it's the 1st or the 10th,
  271. only the Month (12) will make any difference.
  272.  
  273. Hangem.TXT contains:
  274.  
  275. This is the instruction file for Hang 'Em. When a user selects the
  276. See Instructions option during the game, this file is read for
  277. instructions. This file MUST BE PRESENT and Not altered in any way for
  278. Hang 'Em to run properly
  279.  
  280. BOARD.TXT
  281. ---------
  282. Don't worry about this file. It is created when you run setup.exe
  283. This file tells the game which BBS Software you are running and
  284. tells it to read the correct board file. THERE SHOULD NOT BE A
  285. BOARD.TXT FILE IN THE GAME DIRECTORY IF YOUR RUNNING WILDCAT
  286. PRIOR TO VERSION 3.0+ !
  287. The game looks for this file and defaults to Wildcat if it isn't
  288. found.
  289. For other boards it will contain one line with one of the following:
  290. QuickBBS --------> QBBS     GAP or WILDCAT 3.0+ ------> GAP
  291. PCBoard ---------> PCB      Spitfire -----------------> SPITFIRE
  292.  
  293.  
  294.                           List of Files In Archive
  295.  
  296. The following files are either found in your Hang 'Em Zip or will be
  297. created during the runtime execution of the game.
  298.  
  299.  
  300. Hangem.EXE    <--- Executable Program.
  301.  
  302. Hangem.CFG    <--- Configuration File.
  303.  
  304. Hangem.DAT    <--- Store User's Name, Last Play Date & Score.
  305.  
  306. Hangem.TXT    <--- Instructions Used By Program.
  307.  
  308. BULLET##.SCR *<--- COLOR Bulletin
  309.  
  310. BULLET##.BBS *<--- MONO Bulletin
  311.  
  312. Hangem.DOC    <--- This File.
  313.  
  314. WORD1.LST    <--- List of words used during game play.
  315.  
  316. WORD2.LST    <--- List of words used during game play.
  317.  
  318. WORD3.LST    <--- List of words used during game play.
  319.  
  320. WORD4.LST    <--- List of words used during game play.
  321.  
  322. WORD5.LST    <--- List of words used during game play.
  323.  
  324. Setup.EXE    <--- Executable setup program for the game.
  325.  
  326. Port.Doc     <--- Instructions for setup of Non-standard address's or IRQ's
  327.  
  328. * DENOTES that file is created during RUN-TIME.
  329.  
  330.                    Hang 'Em  (C)opyright 1990  Page - 5
  331.  
  332.  
  333.  
  334.                                   Batch Files
  335.                                =================
  336.  
  337. Be sure that you have edited or created the HANGEM.CFG file with the correct
  338. information as described earlier in these docs. The individual setups do not
  339. repeat this necessary process.
  340.  
  341.  
  342.  
  343.  
  344.  
  345. Wildcat! 1.13 & 2.0+ Setup:
  346. ---------------------------
  347. First, create your DOOR##.BAT (2.0+) or LIVE##.BAT (1.13) like this eample:
  348.  
  349.    ECHO OFF
  350.    CD \WILDCAT\DOORS\HANGEM
  351.    HANGEM HANGEM.CFG
  352.    CD \WILDCAT
  353.    CAT.BAT
  354.  
  355. place this batch file in your Node# directory if running Multi-Nodes or in
  356. your Wildcat (default) directory if single node.
  357.  
  358. Second, Create a sub-directory for the door program such as in the following
  359. example:
  360.  
  361. C:\WILDCAT\DOORS\HANGEM
  362.  
  363. Third, put the HANGEM game files in the \WILDCAT\DOORS\HANGEM directory.
  364.  
  365. Forth, add this game to your live program menu for user selection and your
  366. ready to run the door.
  367.  
  368. If this is a little unclear then please read your systems documentation for
  369. more detailed instructions.
  370.  
  371. If you use a door monitoring program then read their documentation for
  372. their specific setup.
  373.  
  374.  
  375. Gap Setup:
  376. ----------
  377. First, add the number and name of the door to your menu. This will allow the
  378. user to select the door by number.
  379.  
  380. Second, edit or create the file called DOORS.DAT which is normally in the GEN
  381. directory. Following is an example line to add:
  382.  
  383.    HM 10
  384.  
  385. where 'HM' stands for the name of the batch file (shown below) to invoke the
  386. the door and '10' is the required security level.
  387.  
  388. Third, create a sub-directory for HANGEM to be placed in. And example
  389. would be:
  390.  
  391. C:\GAP\HANGEM
  392.  
  393. place all the files in the HANGEM.ZIP archive inside this directory.
  394.  
  395.  
  396.                    Hang 'Em  (C)opyright 1990  Page - 6
  397.  
  398. Forth, create a batch file called HANGEM which should be placed in the
  399. default directory. Following is example contents of this file:
  400.  
  401.    ECHO OFF
  402.    CD\GAP\HANGEM
  403.    HANGEM HANGEM.CFG
  404.    CD\GAP
  405.    GAP
  406.  
  407. the last line in the HANGEM file should invoke the batch file which loads
  408. the GAP BBS system.
  409.  
  410. If this is a little unclear then please read your systems documentation for
  411. more detailed instructions.
  412.  
  413. If you use a door monitoring program then read their documentation for
  414. their specific setup.
  415.  
  416.  
  417.  
  418. Spitfire Setup:
  419. ---------------
  420. First edit your SFDOOR.MNU and add the following line. If you are not running
  421. and doors at this time you will need to create this file.
  422.  
  423.    HANGEM, 10
  424.  
  425.    Where HANGEM is the name of the door to appear on your menu and the 10
  426.    is the lowest security level that will be allowed to enter the door. Don't
  427.    forget the comma (,) after the name.
  428.  
  429. Second create a sub-directory to place the door game in. In this example we
  430. will use 'C:\SF\DOOR_A' for the game directory.
  431.  
  432.  
  433. Third move all the files in the HANGEM.ZIP archive into this directory.
  434.  
  435. Forth edit your SF.BAT file adding the following lines.
  436.  
  437. :DOOR_A
  438.    CD\SF\DOORS_A
  439.    HANGEM HANGEM.CFG
  440.    CD\SF
  441.    GOTO LOOP
  442.  
  443. Fifth, rerun Sf.BAT and your ready to begin play.
  444.  
  445. If this is a little unclear then please read your systems documentation for
  446. more detailed instructions.
  447.  
  448. If you use a door monitoring program then read their documentation for
  449. their specific setup.
  450.  
  451.  
  452. PCBoard 14.0+ Setup:
  453. --------------------
  454. First, edit your DOORS and DOORSG file so that it shows HANGEM with the door
  455. number relating to it's position in DOORS.DAT.
  456.  
  457. Second, edit the DOORS.DAT file so that it includes HANGEM.
  458.  
  459. Third, create a sub-directory for HANGEM to be placed in. And example
  460. would be:
  461.  
  462.                    Hang 'Em  (C)opyright 1990  Page - 7
  463.  
  464. C:\PCB\HANGEM
  465.  
  466. place all the files in the HANGEM.ZIP archive inside this directory.
  467.  
  468. Forth, create a batch file called HANGEM which should be placed in the
  469. default directory. Following is example contents of this file:
  470.  
  471.    ECHO OFF
  472.    CD\PCB\HANGEM
  473.    HANGEM HANGEM.CFG
  474.    CD\PCB
  475.    BOARD
  476.  
  477. the last line in the HANGEM file should invoke the batch file which loads
  478. the PCboard BBS system.
  479.  
  480. If this is a little unclear then please read your systems documentation for
  481. more detailed instructions.
  482.  
  483. If you use a door monitoring program then read their documentation for
  484. their specific setup.
  485.  
  486.  
  487. QuickBBS Setup:
  488. ---------------
  489. First, add the game to your games menu and select the correct type for doors.
  490.  
  491. Second, create a sub-directory for the game and move all the files from the
  492. zip file to this directory.
  493.  
  494. Third, the game reads the file DORINFOx.DEF. Where 'x' is the node number.
  495. Since QuickBBS only supports one node at this time then this file should be
  496. 'DORINFO1.DEF'. This file's drive\path\filename should be on the third line
  497. of the configuration file.
  498.  
  499.    Note: It was told to me that the upcoming 3.0 version of QuickBBS will
  500.          support Multi-Nodes and that the 'DORINFOx.DEF' will be changed
  501.          to 'DORINFxx.DEF' to support Multi-Nodes. This game is written
  502.          where you can specify this new name as well as any others.
  503.  
  504. Forth, create a batch file called HANGEM which should be placed in the
  505. default directory. Following is example contents of this file:
  506.  
  507.    ECHO OFF
  508.    CD\QUICKBBS\HANGEM
  509.    HANGEM HANGEM.CFG
  510.    CD\QUICKBBS
  511.    QBBS.BAT
  512.  
  513. the last line in the HANGEM file should invoke the batch file which loads
  514. the QuickBBS system.
  515.  
  516. If this is a little unclear then please read your systems documentation for
  517. more detailed instructions.
  518.  
  519. If you use a door monitoring program then read their documentation for
  520. their specific setup.
  521.  
  522.                             Technical Support
  523.  
  524. If you have problems with the Multi-board Hang 'Em live game you may
  525. contact Mike Wilson at the Secret Service BBS 24 hours per day.
  526.  
  527.  
  528.                    Hang 'Em  (C)opyright 1990  Page - 8
  529.  
  530.  
  531.  
  532.                               Order Information
  533.  
  534.  
  535. Just mail $15.00 Check, Money Order or Cash to:
  536. Please include your board name with your order
  537. as you want it to appear within the program.
  538. VISA or MASTERCARD Welcome!
  539.  
  540.                  Mike Wilson
  541.                  P.O. Box 9521
  542.                  Huntington, WV 25704
  543.  
  544.  
  545. Make Checks out to Mike Wilson.
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.                    Hang 'Em  (C)opyright 1990  Page - 9